目次 :

Visual Studioテンプレートの作成

プロジェクトテンプレート

手順1. テンプレートの作成

1. 出力するプロジェクトを整理する。 (テンプレートに含める内容のみを残す。)
2. 「プロジェクト」>「テンプレートのエクスポート」を選択する。
3. ラジオボタン「プロジェクト テンプレート」にチェックを入れ、 テンプレートとしてエクスポートするプロジェクトを選択し、「次へ」をクリックする。
4. 「テンプレート名」、「テンプレートの説明」を入力し、「完了」をクリックすると、「出力場所」にテンプレート(ZIP)が出力される。 ここで、「テンプレートを自動的にVisual Studioにインポート」にチェックを入れると、システムのテンプレートに組み込まれ、すぐに使用できるようになる。 (その環境でのみ)

手順2. テンプレートのインポート

1. ユーザープロジェクトテンプレートの場所を確認する。 メニューから「ツール」＞「オプション」を選択してオプションを開き、 「すべての設定」＞「プロジェクトとソリューション」＞「場所」を選択する。 このとき、テンプレートの場所は任意に変更してよい。 (プロジェクトの場所(デフォルト)も参照。)
2. 1. の場所にプロジェクトテンプレート(ZIP)を配置する。 サブディレクトリ(1. でプロジェクトテンプレートの場所を変更するとサブディレクトリが自動生成される)への配置も可能だが、 有効なサブディレクトリ名は限られていることに注意。 (例えばVS2022では「Visual C#」は有効だが「C#」は無効。) 配置後にテンプレートを削除すると、そのテンプレートは使用できなくなる。

手順3. テンプレートの呼び出し

手順1で作成したテンプレートは組み込みのテンプレートと同様、プロジェクトの新規作成時に雛形として使用できる。 ただし、組み込みテンプレートと異なり、プラットフォームおよびプロジェクト種類のタグが付与されていない。 (「言語」はテンプレート作成時に元となったプロジェクトのものが適用される。) 「すべてのプラットフォーム」、「すべてのプロジェクトの種類」を選択して絞り込みを解除した上で テンプレートを特定できる語句を検索欄に入力し、テンプレートを選択する。 以降は組み込みテンプレートと同様。

手順4. テンプレートの編集

VSTEMPLATE の例

項目テンプレート

有効な場面

上図のように、Window に外部ファイルで定義されるリソースを適用する場合を考える。 リソースファイルの指定やスタイル(キー)の指定がボイラープレートとなっているため、 Window を項目テンプレートとすることで、ボイラープレートを都度記述する必要がなくなる。 このとき、テンプレート化する MainWindow が参照している(依存関係にある) _Style/General.xaml も項目テンプレートに含まれるため、 依存関係にあるファイルを都度プロジェクトに追加する必要もない。

テンプレートの作成

1. 「プロジェクト」>「テンプレートのエクスポート」を選択する(プロジェクトテンプレートと共通)。
2. ラジオボタン「項目テンプレート」にチェックを入れ、 エクスポートする項目が含まれるプロジェクトを選択し、「次へ」をクリックする。
3. エクスポートする項目にチェックを入れ、「次へ」をクリックする。 (ここでは MainWindow.xaml を選択。)
4. テンプレートに参照を含める場合、必要なものにチェックを入れる。「次へ」をクリックする。
5. 「テンプレート名」、「テンプレートの説明」を入力し、「完了」をクリックすると、「出力場所」にテンプレート(ZIP)が出力される(プロジェクトテンプレートと共通)。